home *** CD-ROM | disk | FTP | other *** search
/ BMUG Revelations / BMUG Revelations.toast / Utilities / Random / Commodore 64c / 0.1 - README next >
Text File  |  1994-02-28  |  6KB  |  132 lines
  1. Commodore 64 Emulator Version 0.1 Readme
  2. (C) 1993-4 Earle F. Philhower III (st916w9r@dunx1.ocs.drexel.edu)
  3. You MUST own a Commodore 64 to use this program, as it contains
  4. the Commodore 64 ROMs, which are (C)CBM Corp., within its code.
  5.  
  6. You should also have recieved this package with a file called
  7. "COPYING" which contains the GPL license which it is distributed under.
  8.  
  9.  
  10.     This program is free software; you can redistribute it and/or modify
  11.     it under the terms of the GNU General Public License as published by
  12.     the Free Software Foundation; either version 2 of the License, or
  13.     (at your option) any later version.
  14.  
  15.     This program is distributed in the hope that it will be useful,
  16.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  17.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18.     GNU General Public License for more details.
  19.  
  20.     You should have received a copy of the GNU General Public License
  21.     along with this program; if not, write to the Free Software
  22.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  23.  
  24. ----- 0.1 README -----
  25. Read the 0.1 Beta section below first...
  26. Updates/Bug Fixes:
  27.     Only a 68000 version supplied.  The 020 version wasn't any faster. :<
  28.     Improved Keyboard Mapping:
  29.         DELETE    =    C64 delete
  30.         ESC    =    RUN/STOP
  31.         `    =    RUN/STOP-RESTORE
  32.     When in emulation mode, COMMAND-<key> is in effect, and you
  33.       can now bring up menus w/o stopping the emulation.
  34.     When placed into the background, emulation is automagically suspended.
  35.     No longer hogs 100% of CPU time when emulating (for updates/network.etc)
  36.     Window is snapped onto a BYTE grid horizontally for faster BITBLITS
  37.     When an unimplemented instruction is encountered, only the C64 will
  38.       crash, and not the whole MacOS (I was taking the emulation a bit too
  39.       far ;-> )
  40.     Hi-Res mode now works properly, and won't crash MacOS.
  41.     Printer Support:
  42.       Device #4 (CBM Printer) is directed to a Mac file called "PRINTER"
  43.       in the directory the program is run from.  This will be changed
  44.       in a later release.
  45.     Doesn't hog CPU when displaying ABOUT box.
  46.     BRK instruction now jumps to the IRQ address, as it should!
  47. Unfixed Bugs/Unimplemented Features:
  48.     ***The whole FILE and EDIT menus are just there for looks***
  49.     ***I haven't written or debugged the code to do those functions***
  50.     Hard Drive (#9) support seems to be flakey, and there are no $ or *
  51.       support yet.
  52.     1541 (#8) still uses c1541 disk images.  This WILL change to .D64
  53.       images (not a big change, but will allow the use of all of the IBM
  54.       transferred software (!!!) on the emulator)
  55.     Typing a key 2 times in a row looks to the computer as if you had
  56.       held the key down for 2x as long, not hitting the key 2x.
  57.     Double-Clicking on a 1541 image starts the emulator, but I haven't
  58.       added Apple Event support to load that image.  Coming RSN!
  59.     Keyboard is not fully mapped from MAC -> C64.  This includes some
  60.       CTL and all COMMODORE key combos.
  61.     I'm looking into a pixel-doubling algorithm to make the VIC screen
  62.       2x normal size, so all you rich people with real Macs can run
  63.       the emulator w/o eyestrain. ;->
  64.     Possibly mapping in CHARROM to the processor space (via addr. 1) may
  65.       do bad things.  I haven't tested this yet.
  66.     Undocumented opcodes aren't implemented yet.  This too will change.
  67.     SPEED SPEED SPEED SPEED:
  68.       I have received the 68K source for a 6502 emulator from
  69.       Pieter van Leuven, who has a Vic-20 emulator available for the Ami.
  70.       I've looked at it, and I think I could either hack his, or write my
  71.       own code w/o too much effort.
  72.     Documentation:
  73.       This documentation sucks.  If you check the time on this file you will
  74.       see that I am writing it at 12:20am on a Monday morning/Sunday nite.
  75.       I'm not really keen on writing a lot of docs on a program that's
  76.       being revamped every two weeks, so this README is all you're gonna
  77.       get, spelling and grammar errors et. al!
  78. *****
  79. My email addresses:
  80.     ephilhow@motown.ge.com:            Will be valid until Mar 30, 1994.
  81.     st916w9r@dunx1.ocs.drexel.edu:     Valid until 1996.
  82. If you've got to get in touch with me, use the .ge.com address until Mar 30,
  83. but after that date I'll be using the .drexel.edu address.
  84.  
  85. ----- 0.1 Beta README -----
  86. This is a *preliminary* version of my Commodore 64 emulator.  This release
  87. is more of a "hacker's release" than a "end-user" one.  Not all of the
  88. routines are bullet-proof, or even implemented :).
  89.  
  90.  
  91. To run the 64 emulator:
  92.     If you have a 68000 series Macintosh (Classic, SE, Plus) run:
  93.             Commodore 64-000
  94.     If you have a 68020+ series Macintosh run:
  95.             Commodore 64-020
  96.             
  97. You'll be presented with a splash screen identifying the (C) and GPL,
  98. and then the Commodore 64 window will be brought up and run.  Just type
  99. and fool around in your *very expensive* C64!
  100.  
  101. The emulator has support for c1541 (x64) type floppy disk images.  To
  102. attach a floppy to drive#8 simply use the "Devices" menu and select
  103. either "Select Floppy Image" or "Create Floppy Image" to create a blank,
  104. formatted 1541 image.  After attaching an image, just do your usual
  105. LOAD "$",8; OPEN 1,8,0,"FILE,S"; etc.
  106.  
  107. Also supported is a "hard drive" interface to your Macintosh HD.  It is
  108. accessed via device #9 and *only* supports LOAD/SAVE/OPEN/PRINT# commands.
  109. No directory support is provided (LOAD"$",9 gives a "File Not Found" error")
  110.  
  111. No joystick or paddle support is available yet, and the printer support
  112. is not nearly usable.  There is no SID chip simulation, this may be done
  113. in the near future.  ***There is no, and will not be, color support for
  114. the VIC chip unless someone else can program it as I only have a Mac
  115. Classic to work with.***  But if someone wants to donate an old LC or
  116. Mac II I'd be more than happy to reprogram my simulation ;>.
  117.  
  118. The VIC chip doesn't have sprite/sprite or sprite/char collisions, but
  119. these would not be too hard to implement using my present code.  VIC
  120. raster interrupts *are* simulated, but the screen is only updated by the
  121. full 200 lines, so split-screen gfx don't work well at all.
  122.  
  123. ------------
  124. "Commodore 64 Emulator...
  125. It's not much, but it's the *only* Commodore 64 you can run on your Mac!"
  126.  
  127. Any user suggestions, bug-fixes, updates please email to the above address
  128. (st916w9r@dunx1.ocs.drexel.edu).  I'm especially interested in any 68000
  129. based 6510 simulators.  The current code was written for portability
  130. (It took me all of 15 mins to get this code running on my 486 Linux box!),
  131. not breakneck speed.
  132.